Skip to content

Conversation

@beran-t
Copy link
Contributor

@beran-t beran-t commented Feb 3, 2026

Summary

Add a new template example showing how to create a sandbox with Docker installed.

  • Uses the official get.docker.com script for installation
  • Validates Docker works by running hello-world during build
  • Includes example of running Alpine container in the sandbox

Add a new template example showing how to create a sandbox with Docker
installed. Uses the official get.docker.com script for installation
and validates with hello-world during build.
- Remove section headers
- Use inline code comments instead of prose
- Use sbx variable and sbx.kill() pattern
- Simplify template name to 'docker'
- Add await to sbx.kill() in TypeScript
- Use Sandbox.create() pattern in Python
- Add brief description to Run containers section
Replace Note with inline prose explaining recommended specs (2 CPUs, 2 GB RAM) and bold warning about lower RAM causing OOM errors.

## Install Docker

Use the official installation script from [get.docker.com](https://get.docker.com). The `hello-world` container validates the installation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Use the official installation script from [get.docker.com](https://get.docker.com). The `hello-world` container validates the installation.
Use the official installation script from [get.docker.com](https://get.docker.com). The `hello-world` container run validates the installation.


## Build the template

We recommend at least 2 CPUs and 2 GB of RAM for running Docker containers. **With lower RAM, your sandbox might run out of memory when working with containers.**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
We recommend at least 2 CPUs and 2 GB of RAM for running Docker containers. **With lower RAM, your sandbox might run out of memory when working with containers.**
We recommend at least 2 CPUs and 2 GB of RAM for running Docker containers. **With lower RAM, your sandbox might run out of memory.**

- Add "run" to hello-world validation sentence
- Simplify RAM warning text
@beran-t beran-t merged commit 1747296 into main Feb 6, 2026
5 checks passed
@beran-t beran-t deleted the docker-template-example branch February 6, 2026 00:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants